Class sjl.InsertIterator
All Packages Class Hierarchy This Package Previous Next Index
Class sjl.InsertIterator
java.lang.Object
|
+----sjl.Iter
|
+----sjl.InsertIterator
- public class InsertIterator
- extends Iter
- implements OutputIterator
An iterator adapter that causes all assignment operations (put) to be
converted into an insert
operation.
When the InsertIterator
is constructed a container which
implements the SequenceContainer
is supplied.
Currently the List, the
Deque and Vector
implements SequenceContainer
.
Copyright © 1996 Finn Bock
- See Also:
- List, Deque, Vector
-
InsertIterator(SequenceContainer, Iterator)
- Construct an insert iterator for the container, which convert all
assigments (put) into the insert method.
-
cmp(Iterator)
- Invalid.
-
genericCopy()
- Return this.
-
next()
- Do nothing.
-
put(Object)
- Insert object at the front of the container.
-
setTo(Iterator)
- Assign this iterator to another container.
InsertIterator
public InsertIterator(SequenceContainer container,
Iterator iter)
- Construct an insert iterator for the container, which convert all
assigments (put) into the insert method. The container must
be a SequenceContainer, that is, it must support the
insert(Iterator, value) method.
put
public Object put(Object object)
- Insert object at the front of the container.
- Parameters:
- object - The object that will be inserted in the container
- Returns:
- object is returned.
next
public Iterator next()
- Do nothing. All assignment to this iterator will always be at the
front of the container, so advancing the iterator is ignored.
cmp
public boolean cmp(Iterator i)
- Invalid. This method is inherited from Iterator, but should
not exist in an OutputIterator.
XXX: Throw an exception perhaps??.
genericCopy
public Iterator genericCopy()
- Return this. Since insert iterators does not maintain any position,
there is no need for actually clone the iterator.
setTo
public void setTo(Iterator i)
- Assign this iterator to another container. This is faster than creating
a new InsertIterator object.
All Packages Class Hierarchy This Package Previous Next Index